home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / now_then.zip / NOW&THEN.DOC < prev    next >
Text File  |  1995-01-11  |  13KB  |  379 lines
  1.                                   
  2.                                   
  3.                                   
  4.                                   
  5.                                   
  6.                                   
  7.                                   
  8.                                   
  9.                                   
  10.                                   
  11.                                   
  12.                                   
  13.                                   
  14.                                   
  15.                                   
  16.                                   
  17.                                   
  18.                                   
  19.                                   
  20.                                   
  21.                                   Now & Then
  22.                                  Version  1.0
  23.                     ──────────────────────────────────────
  24.                      Copyright 1995 by Computer Solutions
  25.                              All Rights Reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                   P R O G R A M    D O C U M E N T A T I O N
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.       
  54.       
  55.       
  56.       
  57.       
  58.       (For a quick summary of options, type NOW&THEN at the dos prompt.)
  59.   ┌───────────────────╖
  60. ──┤ About The Program ╟───────────────────────────────────────────────────────
  61.   ╘═══════════════════╝
  62.  
  63. "Now & Then" is a small program which will execute a DOS command or program
  64. one time during a user defined period of time, which is measured in days.
  65.  
  66. This program was created because of my own desire for perfection (not that
  67. this program claims to be perfect).  The commercial utility I was using for
  68. this purpose lacked the flexibility I needed.  This sent me on a search of a
  69. similar utility on the net and on local bulletin boards.  I found half-a-dozen
  70. possibilities, but none of those were flexible enough either.  So I finally
  71. conceded and decided to write my own.
  72.  
  73. While writing this utility, I tried to keep other people in mind as well.
  74. Program functionality and flexibility was the most important aspect, second
  75. only to ease of use.  This documentation alone proves that I kept the rest
  76. of the world in mind.  I can not believe that no one else needed the same
  77. functionality I need.
  78.  
  79.  
  80.   ┌─────────────────────╖
  81. ──┤ Command Line Syntax ╟─────────────────────────────────────────────────────
  82.   ╘═════════════════════╝
  83.  
  84. Syntax:
  85.  
  86.       NOW&THEN [options] interval-in-days command
  87.             
  88. [options]
  89.       Options allow you to customize various settings.
  90.  
  91. interval-in-days
  92.       This specifies the frequency which the command should be executed.
  93.  
  94. command
  95.       This specifies the command which to execute.  You may pass as many
  96.       parameters to the command as you like.  However, if parameters 
  97.       beginning with "-" or "/" are passed to the command, you need to
  98.       enclose the entire command in quotations.  This is required because
  99.       of the way Now & Then parses its own parameters.  Without the
  100.       quotations, Now & Then thinks the parameters were meant for it, not
  101.       for the command.
  102.  
  103.  
  104.      
  105.      
  106.  
  107.      
  108.      
  109.      
  110.      
  111.      
  112.      
  113.      
  114.      
  115.      
  116.      
  117.      
  118.      
  119.      
  120.      
  121.      
  122.      January, 1995                Now & Then                         Page 1
  123.   ┌──────────────────────╖
  124. ──┤ Command Line Options ╟────────────────────────────────────────────────────
  125.   ╘══════════════════════╝
  126.  
  127.               ∙ may be specified in any order
  128.               ∙ may be upper or lower case
  129.               ∙ must be preceded by a slash (/) or a minus (-)
  130.               ∙ must be separated by a space ( )
  131.  
  132. /? (Help)            
  133.        Displays a usage screen.
  134.  
  135. /q (Quite Mode)         
  136.        Normally the program displays informational output telling the user
  137.        if the command was executed or not.  This option suppresses that
  138.        informational output.  Combined with the >NUL redirection (see below),
  139.        this will completely disable output from most programs.
  140.  
  141. /n (Nothing)         
  142.        Don't perform the task or update the data file.  This option is mainly
  143.        used for testing purposes, to determine if the command is scheduled to
  144.        run or not.  Idea taken from 4DOS, and has since been very useful.
  145.  
  146. /u (Update)         
  147.        Don't update the data file.  If the command is scheduled to execute,
  148.        the data file is normally updated so the command will not run until it
  149.        is scheduled to run again.  This option prevents the data file from
  150.        being updated.
  151.  
  152. /f=file.ext (Data file name)
  153.        Specify the name of the date file to use.  You can specify the entire
  154.        path of the file and the extension.  If you don't specify a path, the
  155.        current directory is used.  If you don't specify an extension, .DAY
  156.        is used.  If you don't use this option, a data file will be created
  157.        in the same directory as the Now & Then executable.
  158.  
  159. >NUL (Output Redirection)
  160.        This is actually part of DOS, but it is quite handy when used in
  161.        conjunction with Now & Then.  DOS will suppress program output when
  162.        you place >NUL at the end of your command.  When used in conjunction
  163.        with the /q option above, this will usually suppress the output of
  164.        your command.  Note that some programs write directly to video,
  165.        bypassing the BIOS.  >NUL does not suppress the output of such
  166.        programs.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.      
  175.  
  176.      
  177.      
  178.      
  179.      
  180.      
  181.      
  182.      
  183.      
  184.      
  185.      
  186.      January, 1995                Now & Then                         Page 2
  187.   ┌──────────────────╖
  188. ──┤   How It Works   ╟────────────────────────────────────────────────────────
  189.   ╘══════════════════╝
  190.  
  191. The data file keeps up with each task and last run date.  The entire
  192. command line is kept for each task, including all options.  This allows
  193. you to execute the same program with different options on different days.
  194.  
  195. By allowing the user to specify the data file to use, the program is able to
  196. keep track of the same set of commands for different purposes.  For example,
  197. my office has five networked computers.  This program resides on our server
  198. and is used to perform daily maintenance for each machine.  The same set of
  199. programs runs on each machine, therefore the need for each machine to have
  200. its own data file.
  201.  
  202. Many of the programs I found have various limitations with the data file.
  203. Some required the data file to reside in the root directory.  Others required
  204. the data file to reside in the same directory as the program itself.
  205.  
  206. Some programs required that the commands to execute were contained in a
  207. specific BAT file that was in a specific location.  Some programs limited the
  208. number of options you could pass the command.  Some programs had a slew of
  209. required command line parameters.  Other programs only allowed one command
  210. executed per day.  
  211.  
  212. I wanted a program with no limitations, and Now & Then is the result.
  213.  
  214. Unfortunately, there is a minor limitation.  The command that is executed has
  215. its own program environment, which is deleted when the command is completed.
  216. Therefore, if your command alters the environment (such as a SET or PATH
  217. command), it will not alter the master environment.  A command such as
  218. NOW&THEN 1 SET FIRSTBOOT=TRUE would not have an effect, and FIRSTBOOT
  219. would not be set.  This is DOS's behavior and is beyond my control.  
  220.  
  221.  
  222.   ┌──────────────────╖
  223. ──┤ Future Additions ╟────────────────────────────────────────────────────────
  224.   ╘══════════════════╝
  225.  
  226. Although this program does everything I need it to do, there are a couple of
  227. features that I am thinking about adding.  If you would like to see any of
  228. these features added, or if you have another feature you need, please contact
  229. me.  None of these features are terribly complicated or should take too long.
  230. Nonetheless, it currently does what I need and I'm ready to continue on with
  231. another project for now.
  232.  
  233.   Command line examples provided in this documentation.
  234.      
  235.   Enhanced ERRORLEVEL support.  Currently, ERRORLEVEL is used to indicate
  236.   there was an error during Now & Then's execution.  I would like to add
  237.   support to indicate if the program was scheduled to run.  Then, with
  238.   the addition of another switch, a batch file could easily determine if
  239.   a command was scheduled to run.  This could solve the problem with the
  240.   NOW&THEN 1 SET FIRSTBOOT=TRUE example above.
  241.      
  242.   The ability to specify once a month, week, or year, followed by a day
  243.   of week or date specification.  These features are in the Once-A utility
  244.   written by William Waldrop.
  245.  
  246.  
  247.  
  248.      
  249.      
  250.      January, 1995                Now & Then                         Page 3
  251.   ┌──────────────────╖
  252. ──┤  Thank You List  ╟────────────────────────────────────────────────────────
  253.   ╘══════════════════╝
  254.   
  255. All of the following shareware authors deserve much thanks for their work.  I
  256. have taken ideas from their programs and documentation for use in Now & Then.
  257.  
  258.   Program Ideas
  259.  
  260.     Gene Allison, author of ONCEADAY
  261.     Samuel Kaplin, author of Interval
  262.     Stephen Baines, author of Once Only
  263.     Joseph Sheppard, author of DayBat
  264.     William Waldrop, author of Once-A
  265.  
  266.   Documentation Ideas
  267.  
  268.     Andy Hakim, author of NoHiss
  269.     Tom Rathborne, author of Totally Unlimited's ModUtils
  270.     Chris S. Craig, author of ScopeTrax
  271.     Nicola Ferioli, author of VocPack
  272.  
  273.  
  274. I would also like to thank the following people for reviewing this
  275. documentation before its release:
  276.  
  277.     Aimee Richards, the love of my life and co-owner of Computer Solutions.
  278.  
  279.     Gary Fambrough, Charlie Rowland, and Alyce Hardee, my co-workers at
  280.     High Q Incorporated. 
  281.  
  282.   
  283.   ┌──────────────────╖
  284. ──┤ Revision History ╟────────────────────────────────────────────────────────
  285.   ╘══════════════════╝
  286.  
  287. 1.0    01/11/95  First release.
  288.  
  289.  
  290.   ┌──────────────────╖
  291. ──┤ About The Author ╟────────────────────────────────────────────────────────
  292.   ╘══════════════════╝
  293.  
  294. Computer Solutions is a small, computer consulting firm which Aimee & I
  295. started in the Summer of 1994.  Feel free to contact us with any ideas,
  296. comments, suggestions, or questions you may have.
  297.  
  298.                  US Mail │ Computer Solutions
  299.                          │ 12111 West Markham Suite 14-121
  300.                          │ Little Rock, AR  72211
  301.                          │
  302.                Telephone │ (501) 660-9787
  303.                          │
  304.          Electronic Mail │ jon.robertson@grapevine.lrk.ar.us
  305.                          │
  306.           Bulletin Board │ Ferret Face
  307.                          │ (501) 791-0124
  308.                          │ 2400/14400/28800 baud, HST/v.32/v.FC
  309.                          │ Username: Jon Robertson
  310.  
  311.  
  312.      
  313.      
  314.      January, 1995                Now & Then                         Page 4
  315.   ┌──────────────────╖
  316. ──┤    Legal Talk    ╟────────────────────────────────────────────────────────
  317.   ╘══════════════════╝
  318.      
  319. This program is FreeWare.  Individuals are granted the right to freely use
  320. Now & Then without any concern for registration.  Corporate users must contact
  321. me for a site license agreement.
  322.  
  323. While this program works great with the six machines I've used, I can not
  324. guarantee that it will work on every system.  Therefore, this program carries
  325. no warranties, expressed or implied.  If you have a problem, please contact me.
  326.  
  327. You may freely distribute Now & Then to others as long as:
  328.  
  329.                  ∙  Only the original files are distributed
  330.                  ∙  No changes are made to any of the files
  331.                  ∙  No money is charged for the program
  332.  
  333. Now & Then may be freely included on any form of compilation disk or
  334. shareware library, except disks or libraries that charge *per program*,
  335. rather than per disk of programs.
  336.  
  337. This program is not crippled in any way and does not contain any 'nag'
  338. messages.  In fact, if the right options are specified, nothing is ever
  339. displayed on the screen.
  340.  
  341. Now & Then and this documentation are Copyright 1995 by Computer Solutions,
  342. All Rights Reserved.  The author of this program is not liable for any damage
  343. caused by its use.  By using this program, you agree to the above conditions.
  344.  
  345.  
  346.      
  347.      
  348.      
  349.      
  350.      
  351.      
  352.      
  353.      
  354.      
  355.      
  356.      
  357.      
  358.      
  359.      
  360.      
  361.      
  362.      
  363.      
  364.      
  365.      
  366.      
  367.      
  368.      
  369.      
  370.      
  371.      
  372.      
  373.      
  374.      
  375.      
  376.      
  377.      
  378.      January, 1995                Now & Then                         Page 5
  379.